home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1995 October / EnigmA AMIGA RUN 01 (1995)(G.R. Edizioni)(IT)[!][issue 1995-10][Aminet 7].iso / Aminet / comm / fido / jm950618.lha / docs / jamsched.doc < prev    next >
Text File  |  1995-06-09  |  5KB  |  129 lines
  1.  
  2.                           -==* JamSched 0.40 *==-
  3.  
  4.                             By James McOrmond
  5.                                June 9, 1995
  6.  
  7.  
  8. Note: Contact addresses, and the Changelog are at the end of this file.
  9.  
  10. This is essentially the new "version" of JamTool.  The last remaining
  11. functions of JamTool being used by JamMail are now in this program.
  12. Since it is no longer a general purpose "Tool", and only has Scheduler
  13. functions remaining, I thought a rename was due.
  14.  
  15. This is primarily a cleanup release.  Some previous versions of JamTool
  16. had a few problems in different areas.  I'm hoping that this one solves
  17. them, and is still "smooth" in operation.
  18.  
  19. -----------------------------------------------------------------------
  20.  
  21. JamSched is a utility that WPL based mailer authors can use for a basic
  22. call scheduler.  It has three relatively advanced features.
  23.  
  24.   1) It supports the MINPRI and MAXPRI environment variables for
  25.      selecting which priorities of mail (as listed in Xferq.library)
  26.      are allowed to be sent during this time.
  27.  
  28.   2) It counts the number of BUSY, CONNECT, MAID and other types of
  29.      responses that come back from the modem (as configured in the WPL
  30.      mailer) and will cause the scheduler scanning routine to dial the
  31.      site less often when BUSY and NO CARRIER responses occur.
  32.  
  33.   3) It will schedule calls for UUCP type mail transfers if told to do
  34.      so, and there is outbound bundles waiting in UUSPOOL: for any
  35.      site correctly listed in the L.sys file (specifically must have
  36.      ANY in the dial time field).
  37.  
  38. ----------------------------------------------------------------------
  39.  
  40. JamSched is part of the JamMail network mailer frontend system.
  41.  
  42. If you are a JamMail user, this documentation really is of no use to
  43. you, but is included in the archive for completeness.
  44.  
  45. ----------------------------------------------------------------------
  46.  
  47.  Dialing Response Code: (-r)
  48.  
  49. This function takes two options, the first one being the systems address
  50. and the second being the response type as returned from the modem after
  51. a dial ("CONNECT", "BUSY", "MAID", etc).
  52.  
  53.  
  54. The following WPL code is used in JamMail for this function.
  55.  
  56.    RexxMsg SY REXX "Address 'COMMAND' 'JamSched -r $(Remote.Address) $(event)'"
  57.  
  58. This code is immediately after the GetResponse command after an outbound
  59. Dial command.
  60.  
  61.  
  62. Caveats: This function is not used for counting failed sessions.  It
  63. assumes that if you can connect to the site, the session (whatever type
  64. of session this is) will succeed.
  65.  
  66. ------
  67.  Scheduler: (-s) option
  68.  
  69.  This function scans XferQ.library for systems with outbound mail of at
  70. least priority 50  (crash) (or the number  stored in the ENV:  variable
  71. "minpri"),  and scans the UUSPOOL:  directory for  C.#? files  to go to
  72. sites listed in your UULIB:l.sys file and creates a list of environment
  73. variables with the sites to call.
  74.  
  75.  $(JamSched/todial)   the number of sites to dial
  76.  $(JamSched/todial-1) site number 1 to dial
  77.  $(JamSched/todial-2) site number 2 to dial
  78.  
  79.  etc..
  80.  
  81. The Scheduler  built into  versions of  JamMail higher than .96 all use
  82. this function.
  83.  
  84. As of JamTool 0.23 this scheduler now counts the number of busy signals
  85. and failed connections (via the -r option above), and will dial less
  86. often if you still have not connected to this system.  The following
  87. function is used to determine the number of "loops" through the
  88. scheduler will be waited until the next dial for this system.
  89.  
  90. towait = (((bad*3)+busy) / 10)
  91.  
  92. Each bad connect is equivalent to 3 busy signals.  After each 15 busy
  93. signals, the system will up the number of loops that it must wait
  94. before dialing the system again.
  95.  
  96.  
  97.  
  98. -----------------------------------------------------------------------
  99.  
  100. If you need to contact me, these are some of my Addresses.
  101.  
  102. FidoNet#1:163/139.0  AKA FidoNet#1:1/139.0
  103. ZyXELNET#18:163/139.0
  104. AmigaNet#40:553/139.0
  105. InterNet: jam@jammys.net
  106.           ab207@Freenet.Carleton.Ca
  107.  
  108. The fidonet JAMMAIL echo is likely a good "public" way to get ahold of
  109. me.  I often read some of the UseNet newsgroups like
  110. comp.sys.amiga.datacomm, but I may miss messages in there, so Email
  111. would be better in that case.
  112.  
  113. Current versions of JamSched are always available by dialing my system
  114. 1:163/139 (613)230-8720, typing "grab", and then typing "JamSched".
  115. JamSched is included in the JamMail archive, so if you are using JamMail
  116. you do not need to grab this archive seperately.
  117.  
  118. -----------------------------------------------------------------------
  119.  
  120.  
  121. 0.40 - Complete re-write of a number of functions.  I started from the 0.29
  122.        sources, so the changes that happened between 0.29 and 0.35 were not
  123.        included.
  124.  
  125.        -r option only needs one address argument
  126.  
  127.        lower variable usage, saves over 2k.
  128.  
  129.